Skip to content

Add watch command for real-time account tracking#3

Open
adityasugandhi wants to merge 1 commit intoInfatoshi:mainfrom
adityasugandhi:feature/watch-command
Open

Add watch command for real-time account tracking#3
adityasugandhi wants to merge 1 commit intoInfatoshi:mainfrom
adityasugandhi:feature/watch-command

Conversation

@adityasugandhi
Copy link

Summary

  • Adds x-cli watch <username> command to poll accounts for new tweets in real-time
  • Supports multiple accounts, keyword filtering (-f), custom poll intervals (-i), desktop notifications (-n), and max tweet limits (--max)
  • Introduces RateLimitError for graceful rate limit handling with automatic backoff
  • Adds since_id support to get_timeline() for efficient incremental polling
  • All existing output formats (-j, -p, -md, default Rich) work with watch

Test plan

  • All 40 tests pass (uv run pytest tests/ -v)
  • x-cli watch --help displays correct usage
  • Live tested x-cli watch CheddarFlow — initializes, resolves user, polls, handles rate limits
  • Verify multi-account watching (x-cli watch CheddarFlow unusual_whales)
  • Verify keyword filtering (x-cli watch CheddarFlow -f "$NVDA")
  • Verify desktop notifications on macOS (--notify)

Closes #2

Adds `x-cli watch <username>` to poll accounts for new tweets and display
them in real-time. Supports multiple accounts, keyword filtering, custom
intervals, desktop notifications (macOS), and all output formats.

Closes Infatoshi#2

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add 'watch' command for real-time account tracking

1 participant